From 98e773d93def3e9c24ae040d256f81ba16491ce8 Mon Sep 17 00:00:00 2001
From: =?utf8?q?Javier=20Jard=C3=B3n?= <jjardon@gnome.org>
Date: Sun, 16 May 2010 02:31:45 +0200
Subject: [PATCH] Move documentation to inline comments: GtkSeparatorToolItem

---
 docs/reference/gtk/tmpl/.gitignore            |  1 +
 .../gtk/tmpl/gtkseparatortoolitem.sgml        | 81 -------------------
 gtk/gtkseparatortoolitem.c                    | 20 +++++
 3 files changed, 21 insertions(+), 81 deletions(-)
 delete mode 100644 docs/reference/gtk/tmpl/gtkseparatortoolitem.sgml

diff --git a/docs/reference/gtk/tmpl/.gitignore b/docs/reference/gtk/tmpl/.gitignore
index c870daad1e..0dc5174d59 100644
--- a/docs/reference/gtk/tmpl/.gitignore
+++ b/docs/reference/gtk/tmpl/.gitignore
@@ -13,6 +13,7 @@ gtkrecentchooserwidget.sgml
 gtkscalebutton.sgml
 gtkseparator.sgml
 gtkseparatormenuitem.sgml
+gtkseparatortoolitem.sgml
 gtkstyle.sgml
 gtktesting.sgml
 gtktextiter.sgml
diff --git a/docs/reference/gtk/tmpl/gtkseparatortoolitem.sgml b/docs/reference/gtk/tmpl/gtkseparatortoolitem.sgml
deleted file mode 100644
index ac868fa1c2..0000000000
--- a/docs/reference/gtk/tmpl/gtkseparatortoolitem.sgml
+++ /dev/null
@@ -1,81 +0,0 @@
-<!-- ##### SECTION Title ##### -->
-GtkSeparatorToolItem
-
-<!-- ##### SECTION Short_Description ##### -->
-A toolbar item that separates groups of other toolbar items
-
-<!-- ##### SECTION Long_Description ##### -->
-<para>
-  A #GtkSeparatorItem is a #GtkToolItem that separates groups of other
-  #GtkToolItems. Depending on the theme, a #GtkSeparatorToolItem will
-  often look like a vertical line on horizontally docked toolbars.
-</para>
-<para>
-If the property "expand" is #TRUE and the property "draw" is #FALSE, a
-#GtkSeparatorToolItem will act as a "spring" that forces other items
-to the ends of the toolbar.
-</para>
-<para>
-  Use gtk_separator_tool_item_new() to create a new #GtkSeparatorToolItem.
-</para>
-
-<!-- ##### SECTION See_Also ##### -->
-<para>
-  <variablelist>
-    <varlistentry>
-      <term>#GtkToolbar</term>
-      <listitem><para>The toolbar widget</para></listitem>
-    </varlistentry>
-    <varlistentry>
-      <term>#GtkRadioToolButton</term>
-      <listitem><para>A toolbar item containing a radio
-	  button</para></listitem>
-    </varlistentry>
-  </variablelist>
-</para>
-
-<!-- ##### SECTION Stability_Level ##### -->
-
-
-<!-- ##### SECTION Image ##### -->
-
-
-<!-- ##### STRUCT GtkSeparatorToolItem ##### -->
-<para>
-The #GtkSeparatorToolItem struct contains only private data and
-should only be accessed through the functions described below.
-</para>
-
-
-<!-- ##### ARG GtkSeparatorToolItem:draw ##### -->
-<para>
-
-</para>
-
-<!-- ##### FUNCTION gtk_separator_tool_item_new ##### -->
-<para>
-
-</para>
-
-@void: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_separator_tool_item_set_draw ##### -->
-<para>
-
-</para>
-
-@item: 
-@draw: 
-
-
-<!-- ##### FUNCTION gtk_separator_tool_item_get_draw ##### -->
-<para>
-
-</para>
-
-@item: 
-@Returns: 
-
-
diff --git a/gtk/gtkseparatortoolitem.c b/gtk/gtkseparatortoolitem.c
index 4aa4b15697..2a35efe5f0 100644
--- a/gtk/gtkseparatortoolitem.c
+++ b/gtk/gtkseparatortoolitem.c
@@ -27,6 +27,26 @@
 #include "gtkprivate.h"
 #include "gtkalias.h"
 
+
+/**
+ * SECTION:gtkseparatortoolitem
+ * @Short_description: A toolbar item that separates groups of other
+ *   toolbar items
+ * @Title: GtkSeparatorToolItem
+ * @See_also: #GtkToolbar, #GtkRadioToolButton
+ *
+ * A #GtkSeparatorItem is a #GtkToolItem that separates groups of other
+ * #GtkToolItems. Depending on the theme, a #GtkSeparatorToolItem will
+ * often look like a vertical line on horizontally docked toolbars.
+ *
+ * If the #GtkToolbar child property "expand" is %TRUE and the property
+ * #GtkSeparatorToolItem:draw is %FALSE, a #GtkSeparatorToolItem will act as
+ * a "spring" that forces other items to the ends of the toolbar.
+ *
+ * Use gtk_separator_tool_item_new() to create a new #GtkSeparatorToolItem.
+ */
+
+
 #define MENU_ID "gtk-separator-tool-item-menu-id"
 
 enum {
-- 
2.30.2